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1.0 Introduction 



This manual 
Microsystems DSC : 



describes the programs on the 
5/4 Diagnostic diskette. (DMS Part # •" 



Digital 



All programs on the DSC 3/4 Diagnostic Diskette are designed 
to run under the standard operating system that DMS provides to 
each customer. Neither the operating system nor CP/M utilities 
is provided on the diagnostic diskette. 



All testsj with the exeption of TEST. SUB and RS2325 have ■'in 
progress-' commands. These commands allow instantaneous command 
summaries? error listoutsj error summaries? and/or optional 
quitting of the program. Except for system failures? this almost 
eliminates the need for a unit to have a dedicated console. This 
allows one console to service many units without the loss of any 
information regarding transcient errors. 



These programs 
Eiiagnostic Diskette: 

TFORMAT 
K-FDTEST 
-s-MEMTEST 

MEMTEST.SUB 
*MEMSHORT 

MEMSHORT.SUB 

PORTTEST 

•»TEST. SUB 
REMEMBER 
HDTEST3M 
I-IDTEST3S 



make up the contents of the DSC 3/4 



Floppy disk test format utility 
Floppy disk test program 
Memory test program 
Submit file for MEMTEST 
Short memory test program 
Submit file for MEMSHORT 
Parallel Port test program 
RS232 Port test program 
CP/M utility test submit file 
TEST . SUB u t i 1 i ty prog r am 
Memorex Hard disk test program 
Shusart Hard disk test program 



(«■) The programs preceded by an asterisk either save? or 
optionally save? information on the diskette. This allows tests 
to proceed without any need of a dedicated console-even should 
the test (and/or system) fail completely. All programs write to 
the same file? CONFILE.TXT . Upon completion or termination of 
any of these test programs? information can be retrieved by 
entering TYPE CONFILE.TXT after a system reset. If the 
information in CONFILE.TXT must be saved? the file should be 
renamed? otherwise one of the other tests could easily destroy 
it. 
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2.0 Multiple Floppy disk testing 



FDTEST 



This test must be preceded bv a FORMAT or- ( preFerabl v) a 
TFORMAT. This prcigram writes to forrriatted disks in three 
successive patterns: Linear? RandoiTu and fixed. In the linear 
write mode? the disk is written to a linear-? track bv track 
•fashion. In the random write mode, each disk is written to in 
randomly selected tracks. In the Fixed write mode? a non- 
changins byte (stored at 103h> is written linearly onto the disk. 
This is used for testing bit-patterns most likely to cause errors 
on the type of drive being tested. After each write is performed 
it is read-tested in two successive patterns! Linear and 
Random. (The read patterns are identical in format as the above 
listed write patterns.) This test is usually run for 
approximately 24 hours. Since valuable error messages might be 
lost if the power fails? or if a terminal error occurs? a disk- 
write-of-consol e-output option is provided. 

In general testing environments? the formatting of the 
diskette and the testing of the diskette are performed on 
different drives. This tests the compatabi 1 ity of both of the 
drives with each other. A complete drive-compatabi 1 i tv test for 
a double drive system therefore consists of two 24-hour tests. 

TEST 1 - TFORMAT disk on A? FDTEST disk on B. Duration: 24 hours 
TEST 2 - TFORMAT disk on B? FDTEST disk, on A. Duration." 24 hours 

If no errors are detected from the first test in- 24 hours 
quit (Q) the test and initiate the second test. If once more no 
errors occur in a 24 hour period? <=iuit (Q) the second test. The 
drives should be considered to be compatible with each other. 

If errors are detected? it is advised that the errors be 
noted? (or saved on the disk-if that option was used-) and the 
test re-executed. If the errors re-appear? closer investigation 
is called for. This will be decribed later. 

If a certain drive is suspected to be faulty? the formatting 
of the diskette and the testing of the diskette should be 
performed on the same drive. This tests the drives compatabi 1 ity 
with itself. Again? 24 hours should be a sufficient test length. 
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STARTING FDTEST 

Reset the system (cold boot) and await the CP/M prompt. 

CP/M 1.4XX 
A>TFORMAT 

Floppy Disk Format program 1 . xx 

Enter drive number (0 - 7) : 1 CO=A drive, I=B drive, etc3 
Single or Double densitysD CS=sin3le dens, D=double dens3 

Type Return to start. <cr> CHit RETURiM when disk is in EG 

FORMAT COMPLETE 

A>FDTEST 

Floppy Disk Test 2.xx for the DSCS and DSC4 

Write buffer to disk or HiNet? Y 

Disk names (A,B,C,D) : ?A 
WAIT-creatins file on disk 

Test which disks (carriage return to terminate)? 
Drive number (0-7)? 1 
Drive number (0-7)? <cr> 
Type Return <cr> 

A command summary is now printed out and the test is 
started. With the options we selected, most of the console 
output will be written to disk. There are three console commands 
that can be entered at any time while the test is in progress. 
The "'in progress'" commands are as follows! 

F - The F (fixed track testing) option is decrifaed below. 

R - Read out the •"'error-' buffer. The program keeps track of 
all write patterns and loop numbers, by writing them to a buffer 
located at 7000h. All errors are written to this buffer, also. 
When the buffer fills past BOOOh the bul-fer is destroyed and re- 
initialised to 7000h . 

S - Print the current status to console. This informs the user 
immediately as to what function is currentl'v being performed, the 
number of errors that have been detected, track and sector under 
test, as well as the time and date. 

T - Restart the test. New test drives can now be selected. 

Q - Optionally quit the program. The program then asks the user 
if an exit is really desired. If a •"Y-' is entered the test will 
terminate, otherwise the test will resume as if not interrupted. 

'? - If any other character is received from the console a menu 
of acceptable commands is printed out. 
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FDTEST Options 



(1) Fixed tiYte, 

The third write stage in anv given 1 cmsp is that of a fixed 
bvte. This bvte provides a bit pattern most likelv to cause a 
failure on a Shugart model SOO floppy drive. This bvte is 
defaulted to B6h can be changed easily through DDT. Simply 
change the byte at 103h to the desired value. 

(2) Maximum number of errors (per- drive) 

The maximum number of any one type of error is stored at 
104h. It is set to 10 (OAh). As in the case of the --fixed byte'" 
above? it also can be easily set to any desired value through 
DDT. When a drive reaches its maximum capacity of errors? it is 
automatically logged out of the test. The log-out feature helps 
maintain testing efficiency. 

(3) Disk write option. 

This writes the contents of the R buffer (the error buffer 
which begins at 7000h) to a user-selected disk. When 128 bytes 
are collected the sectors worth of data is written to the next 
record of CONFILE.TXT. This will continue forever or until the 
disk is full or the test stopped. If desired, any valid CP/M 
file name may be entered on the command line. This file will 
receive the data instead of the default file CONFILE.TXT . 

(4) Fixed track testing option 

If an •-p-" is entered as an ''in-progress'" command the fixed 

track test mode option is selected. In fixed track testing mode 

the user can read or write continuously on any one track. After 

each read or write is performed? the BIOS error code (hex) 
returned to the user. If the number returned? is 00? a 

successful read/write was made. If the BIOS error code is not 

00? an error has occurred. The program will now print out the 

MEC765 error buffer for inspection. The fixed track testing mode 
has its own commands. 

R - Read from the track. 

W - Write to the track. 

T ~ Test a new track. The user selects a new track. 

D ~ Done testing. Return to regular testing. 

X - Finished with the program. eXit to the system. 

(5) Time option. 

FDTEST records the time of the start of each test loop and 
the time of each error. If a system reset is made before the 
test is initiated the time will be set to 00:00:00. This can be 
a direct indicator of how long FDTEST has been running. If 
preferred? the time can be set to the current time thus 
indicating real time instead of elapsed time. 
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FDTEST errors 



What folloLUS is a list of all FDTEST error messages. All 
error messagesj except those noted? are generated bv information 
received from the NEC uPD765 Single/Double density floppy disk 
controller chip. A booklet on this chip is provided to each 
customer with the DSC3/4 manual. Next to each error explanation 
is a NEC code which references the Status Flegister Identification 
section of the NEC booklet. 



DATE XXX-00-00 TIME 00-00-00 

Disk X, ERRORS equipment check Track: XX CCurrent Function] 

NEC flag - EC 

If a fault signal is received from the FDD, or if the Track 

Signal fails to occur after 77 Step pulses (Fcecal ibrate 

Command) then the EC flag is set, thus triggering this error 
message. 



DATE XXX-00-00 TIME 00-00-00 

Disk X, SYNC error - CPU and FDC out of sync Track: XX CCurrent Function: 

No NEC flag. BIOS generated error. 

If the NEC765 controller chip is out of phase with the CPU 
chip, the DMS BIOS reports this error. This indicates that the 
NEC765 chip was/is misprogrammed, or that interrupts have been 
disabled or missed. 



DATE XXX-00-00 TIME 00-00-00 

Disk X, DATA CRC error Track: XX CCurrent Function] 

NEC flag - DE,DD 

When the FDC detects a CRC error in either the ID field or 

the data field, this flag is set. If, in addition the DD flag is 

also set, which indicates that the FDC detected a CRC error in 
the data field, this error message is printed. 
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FD TEST e r r o rs- ( c o n t ) 



DATE XXX-00-00 TIME 00-00-00 

Disk X> TRAC error - head over wrong cylinder Track: XX CCurrent Function^ 

NEC flag - WC 

The WC bit is related to the ND bit> and when the contents 
of C on the medium is diFferent from that stored in the IDRS the 
WC flag is set and triggers this error message. 



DATE XXX-00-00 TIME 00-00-00 

Disk X7 ENDT error - read bevond end of cvlinder Track: XX llCurrent Functio 

NEC flag - EN 

When the FDC tries to access a Sector bevond the final 
Sector of a Cvl inder? this flag is set and triggers this error 
message. 



DATE XXX-00-00 TIME 00-00-00 

Disk X. ID CRC error Track: XX CCurrent Function] 

NEC flag - DE, (DD =0) 

When the FDC detects a CRC error in either the ID field or 
the data field, this flag is set. If the DD flag is not set, 
this error message is generated. 



DATE XXX~00-00 TIME 00-00-00 

Disk X, DMA ORUN - controller not seviced in time Track: XX CCurrent Functi 

NEC flag - OR 

If the FDC is not serviced bv the main-svstems during data 
transfers? uithin a certain time» the OR flag is set and this 
message is printed out. 
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FDTEST errcirs (cont) 



DATE XXX -00-00 TIME 00-00-00 

Disk X» SECT error - Canncit find sector Tracks XX CCurrent FunctionJ 

NEC flag - ND 

During execution of READ DATA, WRITE DELETED DATA, or SCAN 
comrriandj if the FDC cannot find the Sector specified in the IDR 
Register, this flag is set. 

During execution of the READ ID Command, if the FDC cannot 
read the ID field without an error, then this flag is set. 

During the execution of the READ A Cylinder Command, if the 
starting sector cannot be found, then this flag is set. 

If any of the above conditions set the ND flag, then the 
SECT error message is printed. 



DATE XXX-00-00 TIME 00-00-00 

Disk X, PROT error ~ disk wri te-protected. RESTART'' CcrJ C 1 f 3 

NEC flag - WP 

This bit is used to indicate the status of the Ready signal 
from the FDD. If this bit is set, the PROT error message is 
printed and the program restarted. 



DATE XXX~00-00 TIME 00-00-00 

Disk X, DENS error - wrong density (missing ID address mark) 

Track: XX CCurrent Function.! 



NEC flag 



DA TE X X X -00-00 T I ME 00-00-00 

Disk X, MADR error - missing data address mark Tracks XX CCurrent Function] 

NEC /flag - MD 

When data is read from the medium, if the FDC cannot find a 
Data Address Mark or Deleted Data Address Mark, then this flag is 
set and the MADR error is printed out. 
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POTEST errors (cont) 



DATE XXX-00-00 TIME 00-00-00 

Disk- X, COMPARE error." Track: XX CCurrent Function] 

No NEC -flag. Program generated error. 

If the data Prom the write buffer does not match the data in 
the read buffer> then this error message is generated. 



DATE XXX-00-00 TIME 00-00-00 

Disk X, INDETERMINABLE error: Track: XX CCurrent Function] 

NEC flag - 

If the NEC765 Controller chip reports and error? and it does 
not match anv of the previously listed errors? this message is 
printed. 



Could not ujrite data to file 

If the program cannot write the latest console data 
successfully to CGNFILE.TXT, or to the file noted on the command 
line? this error message is printed. 



ERROR OVERFLOW - LOGGING OUT DISK 

If a disk has reached the maximum amount of errors? it is 
logged out of the test. The maximum number of errors- allowed is 
stored in a byte at 104h. See FDTEST Options for more 
information. 



Please note: Both CP/M and BIOS calls are used. The disk 
write feature uses CP/M file management, while the test reads and 
writes are performed through BIOS calls. 
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,0 Memcrv Testing MEMTEST 

MEMSHORT 



The Transcient Program Area (TPA) rnemorv can be tested using 
MEMTEST or MEMSHORT. These programs are identical, exept that 
MEMSHORT uses a quicker test algorithm. These programs urite all 
the console output to disk, specif icallv CONF I LE. TXT . liEMTEST 
and MEMSHORT have one -'in progress-' command. Any console input 
will trigger the message. The message reports the l-ol 1 owing: 

MEMTEST is in prosress 

Current phase is: XX 

Current location under test: XXXX 

Both MEMTEST and MEMSHORT can be used to test the entire TPA 
by using the supplied submit l-iles MEMTEST. SUB and MEMSHORT. SUB. 

During PHASE 01 of MEMTEST or MEMSHORT, memory is 
initialized to zeroes. During PHASE 02 of the test, a 1 is 
walked through a field of zeroes. Next, memory is re-initialized 
to ones. During PHASE 03 a is walked through a field of ones. 
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Starting MEMTEST (cr MEMSHORT) 



Reset the system, 
must be write enabled. 



NEMTEST must be on the boot-up clisk» and 



« Erase any previous data 



« Star tins addr in TPA 

« Te s t length in hex 



CP/M 1.4XX 

A>ERA CONFILE.TXT 

A>MEMTEST 

■H* MEMORY DIAGiMOSTIC -a* 

BEG IN I NG TEST LOCATION (IN HEX)! XXX X 

TOTAL TEST LENGTH IN (HEX) BYTES: XXX X 

TEST INCREMENT (IN HEX):XXXX 

RECORD EACH ERROR ON CONSOLE? (Y OR N)Y « Always yes 

REPEAT TEST? (Y OR N)X « Yes for indefinite test 

« No for one pass only 

PHASE 01 
PHASE 02 
PHASE 03 



0000 0000 0000 0000 0000 
0000 0000 0000 0000 0000 
0000 0000 0000 0000 0000 
0000 0000 0000 0000 0000 
0000 0000 0000 0000 0000 
0000 0000 0000 0000 0000 



MEMTEST (MEMSHORT) OPTIONS 



A>MEMTEST 
A>MEMTEST 1 



This option is described above. 

This option will automatically start MEM- 
TEST on a SOOOh test which starts at iOOh. 



A>MEMTEST 4 



This option will automatically start MEM- 
TEST on a 4000h test which starts at 4000h. 



A>MEMTEST 



This option will automatically start MEM- 
TEST on a 4000h test which starts at SOOOh. 



A>MEMTEST C 



This option will automatically start MEM- 
TEST on a 2000h test which starts at COOOh. 



A>SUBMIT MEMTEST 



This option will erase CONFILE.TXT and set 
UP a submit file to run the four previous 
options se-^uential 1 y. 



Notes All options? excluding the last one? do not erase 
CONFILE.TXT. This is the responsibility of the test technician. 

Notes All above options can be used with MEMSHORT. Merely 
substitute MEMSHORT for MEMTEST 
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4.0 Parallel Port Testing 



PORTTEST 



This program outputs an S bit pattern (starting with 00 and 
ending with FFh ) out of the first parallel port» then reads it in 
to the second parallel port. and compares the two hvte patterns. 
If thev are not identical. an error message is printed to the 
console. Next. the bit pattern is sent out of the second. and 
read in from the first. Again, if the patterns are not identical, 
an error message is printed to the console. Next, the pattern is 
incremented and the test repeated. The test will repeat 
indefinitely, but all patterns will be completely tested in under 
sixty seconds. 



NOTE: A special connector is needed for this test. (DMS PART 
# ????????). 



Starting PORTTEST 



Install the special parallel port interconnecting cable, 
Reset the system. 

A>PCiRTTEST 
PORTTEST VER 1 . xx 



Testing pattern 

*•.■■ •%•* '^•* •■.■* *%' '-.-* •■.** '%•' 



Bit pattern of the byte currently 



being test is printed out here. 

Console "'in progress'' commands are as follows: 

S - Print out a summary of al 1 errors 

that have occurred thus far. (Starts at 500h ) 

Q - Optionally quit the program 

? ~ Any other character generates a command summary 

PORTTEST Error Message 



ERROR PORT xx xxxxxxxx sent, but received xxxaa.>^aa 

port number i 
I 
Pattern sent from port xx 

Pattern received from the other port 
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5.0 RS-232 port testing RS232 



This prosram outputs ascii characters to RS232 ports Oj 2j 
and 3. The three ports are also checked for input. Ii" a 
character is readvj it is read? and if it is a valid printing 
ascii character it is echoed indefinitely (or until another valid 
character is found) to all three ports. 

The program is sel f-startins. It defaults to the character 
•■"A-" (ascii 41h) if no character has been entered on the command 
line. 

Ports 0, 2» and 3 are set to RS232j 9600 baud ports at the 
start of the program. This is necessary because certain versions 
of the DSC 3/4 BIOS initialize the ports differently. 

Starting RS232 

Reset the system. 

CP/M 1.4xx 

A>RS232 B « The •-B" is optional 

RS232 VER 1 , xx 

BBBBBBBBBBBBBBBBBBBBBBBBBBEBBBBBB ( The B-'s print out 

c n t i n u o u s 1 y . ) 

The test is now in progress. Check ports 0? 2? and 3 for 
identical output. Input can be made to any of these ports, also. 
Any valid ascii character that is input will change the output to 
that ascii character. 

RS232 has no error messages. If all port I/O do not produce 
proper and identical results 
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6. CP/M Lit i 1 i tv Tes t i ns TEST. SUB 



This is a test of CP/M disk I/O, CCP, and utility programs. 
The purpose of this test is to exercise the system in a CP/M 
environment with a hish duty cycle. It is usually used to gain 
confidence in the system a-Fter any repair. 

The entire file is listed on the following page. TEST. SUB 
sets UP a perpetual loop that should only terminate when the disk- 
is full. In the loop are commands that exercize DIR, STAT, ASM, 
PIP, ERA, and also DMS utility TIME. This test saves the current 
function it is performing on the disk. Upon system failure, the 
disk-write function allows the test technician to see what 
function was being performed when the system failed. Under 
normal circumstances, the system failure should occur during the 
PIP function. It requires a CP/M disk with the following files: 

ASM.COM TIME.COM SUBMIT.COM MEMTEST.ASM 
TIME.COM PIP.COM STAT.COM REMEMBER.COM 

In addition, another formatted diskette (use FORMAT) is 
required. 

The test is run though the CP/M utility SUBMIT. If the 
reader is unfamiliar with SUBMIT, it is highly reccommended the 
CP/M Manuals be consulted before starting the test. 

Please note the frequent appearance of the file name 
REMEMBER. This trivial program writes the contents of the command 
line (which CP/M puts in a buffer starting at SOh) to CONFILE.TXT. 
If no command line is entered, CONFILE.TXT is erased. This 
allows the test technician to check what function was in progress 
before a system failure occurred. 

This test has no -'in progress'' error messages. If the 
console shows that the submit test is still running, no fatal 
errors have occurred. When MEMSUM.HEX finally overloads the A 
diskette, the test will ungracefully terminate with a CANNOT 
CLOSE FILE or NO DISK SPACE message from PIP. An examination of 
the console, or CONFILE.TXT should reveal the last utility that 
the test performed. If it was PIP, and a STAT command shows no 
read/write space available, the test terminated in an expected 
manner. There is a possibility that REMEMBER tried to write to 
the full disk, thus causing the failure, but since it writes 
only one record, the chance is slim. 

If another command caused the system termination, closer 
examination is needed- If the system failed during the execution 
of ASM, STAT, or SUBMIT, quite possibly a bad copy of the file 
exists on the .diskette. If the system failed during the 
execution of one of the CCP commands (DIR,ERA, or TYPE), quite 
possibly a bad copy of CP/M and/or EHOS is on the diskette. 
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Starting TEST. SUB 

Reset the SYstern. Put the CP/M disk in drive A. and place the 
second disk in drive B. (These disks must be put in their listed 
logical drives. However» the phYsical assignment of A or B can 
be easilY changed through ASSIGN. Both diskettes must be write 
enabl ed. ) 

CP/M 1 . 4xx 

A>SAVE 1 MEMSUN.HEX « This initialises MEMSUM.HEX 

A>SUBMIT TEST 

This starts the submit test.' It will repeat until the file 

MEMSUM.HEX fills the A disk. This test has a special utilitY 

file of its own. REMEMBER. COM is used to write its command line 

to disk. (i.e., REMEMBER STAT will write --STAT-- to disk.) 

REMEMBER writes its data to a CP/M file (which it creates) called 

CONFILE.TXT. 

If the unit under test should happen to fail 7 the function 
it was performing before the failure can be examined. This is 
acheived bY a SYstem reset, and entering TYPE CONFILE.TXT . 

Mere is the contents of TEST. SUB. It is highlY recommended 
the user customize the file to achieve the most efficient form of 
testing for the individual application. 



REMEMBER «- 

REMEMBER DIR «- 

DIR s.COM \ 

DIR A-».??M \ This tests the CP/M DIR function 

DIR B: / 

DIR / 

REMEMBER TIME 

TIME 

REMEMBER STAT 

STAT \ 

STAT B! \ 

STAT *.* / 

STAT B: •»-.;<■/ 

REMEMBER TIME 

TIME 

REMEMBER ASM MEMTEST 

ASM MEMTEST. AAA 



This erases CONFILE.TXT . 

This writes --DIR-- to CONFILE.TXT 



« This writes --TIME'" to CONFILE.TXT . 

« This runs program TIME 

« This writes -'STAT-" to CONFILE.TXT . 

This tests the CP/M STAT function. 



« This writes ''TIME'" to CONFILE.TXT . 

« This runs program TIME 

« This writes --ASM MEMTEST-' to CONFILE.TXT 

<!< This runs the CP/M assembler program and 

creates the file MEMTEST. HEX 



The file is continued on the next page. 
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We update CONFILE.TXT to show uue are doing a PIP ccrrtmand. 
REMEMBER PIP MEMSUM.HEX = MEMSUM.HEX, MEMTEST.HEX 

Next we merge files MEMSUM.HEX and MEMTEST.HEX. MEMSUM.HEX 
increases in siee each loop through the submit file. This will 
eventually fill the diskette! causing a svstem failure. 

PIP MEMSUM.I-IEX = MEMSUM.HEX, MEMTEST.HEX 

All files are noiu copied onto the B drive. This further 
tests the PIP util itv. 



REMEMBER PIP ALL FILES ONTO B DRIVE 
PIP Bs=-!{-.#CVa 

Once more the TIME utility is noted on CONFILE.TXT," and 
tested. 

REMEMBER TIME 
TIME 

The erase command is now noted and tested. 

REMEMBER ERA 
ERA B: -s.COM 
ERA B:k-.??M 



REMEMBER TIME 
TIME 

Once more the TIME utility is noted on CONFILE.TXT, and 
tested, 

SUBMIT TEST 

. The entire test is now restarted. 
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7,0 Netujork Testing WETTEST 

WETTEST is a Diasncstic Network Test for the DMS HiNet 
SYsteiTi. Direct BIOS calls are made, so no network master need be 
in operation. Each station in the test specifies his own station 
number, and the station number he wishes to send to. NETTEST is 
used to test the most basic operations of the HiMet. 

Starting NETTEST 

Reset the system. Rsadv two or more units for network 
interaction. 

CP/M 1.4XX 
A>NETTEST VER 1 . xx 
Network Test Program 

Who am I? (in hex, please) - XX 

To whom do I send (hex, if vou will) - XX 

How long a strins of ES's should I send (in hex) - XX 

Should I initiate the HiNet sending"?' (Y/N) X 

Hit return when you want me to start -CcrlJ- 

*.*.*.«•.*. K-.«-. H-. (the print-out will continue indefinitely.) 

NETTEST errors 



*kTIME-OUT ERROR 
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S.O Hard Disk Testing I-IDTEST3M 

HDTEST3S 
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